home *** CD-ROM | disk | FTP | other *** search
/ Netware Super Library / Netware Super Library.iso / mis_cnvt / dbc15 / dbc15.doc < prev    next >
Text File  |  1994-03-18  |  12KB  |  319 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                     ConQuest Database Converter 1.5
  7.  
  8.                  Copyright (C) 1993-94 - ConQuest Data
  9.  
  10.  
  11.  
  12. DISCLAIMERS, NOTICES AND RIGHTS OF PARTIES:
  13.        
  14.         Before we get you started with the program, you are requested to
  15. read the following information.  It is imperative that you understand
  16. what this program  intends to do for you and what your rights and
  17. obligations are pertaining to the use of this program.
  18.  
  19.  
  20. COPYRIGHT STATEMENT:
  21.  
  22.         All versions of the  ConQuest Database Conversion are
  23. copyrighted and are the property of ConQuest Data,  Clayton  CA.
  24. modification(s) and redistribution of such modification(s)  is  a
  25. violation of copyright.
  26.  
  27.        
  28. NOTICE TO PURCHASERS:
  29.  
  30.         Purchasers of this shareware program are requested  to contact
  31. their shareware Distributor to resolve any conflicts pertaining to the
  32. sale of the evaluation copy of this program.  If satisfaction is not
  33. obtained with the Distributor,  or if any violation of the distributor
  34. restrictions herein are suspected, the user is requested to notify
  35. ConQuest Data at PO BOX 545, Clayton, CA 94517.  ConQuest will not
  36. arbitrate the dispute or refund the purchase price on the behalf of the
  37. Distributor, rather will supply the user with a replacement evaluation
  38. copy of this program for a flat fee of $5.00, inclusive of shipping and
  39. handling.  Distributors are encouraged to offer an unconditional money
  40. back guarantee. However, this is at the discretion of the Distributor.
  41.  
  42.         Those other than shareware Distributors may freely copy this
  43. evaluation copy of the program to allow others to evaluate the program,
  44. but must keep the program and all associated files intact and
  45. unmodified.  Non-distributors may charge an amount consistent with the
  46. cost of the disk used to convey the program.
  47.  
  48.  
  49. GETTING STARTED:
  50.  
  51.         We figured the best way to get started is to give you a Quick
  52. Start tutorial.  This is the simplest way to convert a file from one
  53. format to another.
  54.  
  55.  
  56. QUICKSTART:
  57.  
  58.         At your DOS Prompt type: dbc
  59.  
  60.  
  61.  
  62.                                       - 1 -
  63.  
  64.  
  65.  
  66.  
  67.         Press the Enter Key and you will be presented with the opening
  68. menu. This menu allows you to select a file type, which is either dBase,
  69. Paradox etc.  When you press the Enter Key on a file type, you will be
  70. prompted for a file name to process.
  71.  
  72.         For this Tutorial we have included some sample files to process.
  73. At the Menu select dBase and press the Enter Key.  At the Prompt type:
  74. BUSINESS.DBF and press the Enter Key.  You will see the file name posted
  75. in the upper right window.  Now you can select a file name for the
  76. output file type.
  77.  
  78.         At the Menu use the Down Arrow Key to move to Comma-Delimited
  79. and press the Enter Key.  You will be presented with a prompt again,
  80. type: DBC.CDL and press the Enter Key.  You will be asked if this is
  81. correct.  Respond Yes and you will be presented with a new screen.
  82.  
  83.         Output Fields Selection is what you are looking at.  This is the
  84. place where you decide which fields go into the output file. But we are
  85. going to pass ALL the fields in the input file to the output file.  So
  86. press the <F10> key to continue.  You will be asked if you want to use
  87. All Fields for the output file, respond Yes and it will begin processing
  88. the files.
  89.  
  90.  
  91.                                MAXIMUMS:
  92.  
  93.         All file types have maximums of 4000 bytes per record, 254
  94. fields and 254 bytes in each field.
  95.  
  96.  
  97. FILE TYPES SUPPORTED:
  98.  
  99.                                  dBase
  100.  
  101.         The Input File may be any of the dBase file formats, dBase III,
  102. dBase IV, FoxPro Etc.  Memo Fields are ignored at the present time.
  103. Output Files are written in dBase III or IV format with a maximum of 254
  104. fields and each fields length may be up to 254 characters, the maximum
  105. record length is 4000 characters.  Be reminded that if you are using a
  106. dBase III File that you should limit your number of fields to 128.  No
  107. Indexing is currently supported, you will have to take care of that
  108. yourself in your Database program.  The maximum length allowed for
  109. numeric fields are 19 with maximum decimal places of 15.
  110.  
  111.  
  112.                                 Paradox
  113.  
  114.         Paradox 3.5 ONLY is supported with NO INDEXING.  The reason for
  115. this is: the only access to Paradox files we have to program with is the
  116. Paradox Engine, we have all the latest version(s) up to 3.1, but the
  117. Engine(s) for DOS past version 2.0 are SO FLAKY that we could NOT RELY
  118. on using it for production coding.  If this is an inconvenience, WE
  119. APOLOGIZE and we are currently working on our own routines. On Indexing:
  120. allowing a record size of greater than 1350 bytes is not possible when
  121. you index a Paradox File, so we chose not to Index. The maximum(s)
  122. allowed are the same as the above for dBase.
  123.  
  124.  
  125.  
  126.                                       - 2 -
  127.  
  128.  
  129.  
  130.  
  131.  
  132.                             Comma-Delimited
  133.  
  134.         Comma-Delimited Files are one of the most common types.  The
  135. concept is simple.  Separate each field with a comma.  If the file is a
  136. large one, it will take a while to process.  We will scan the entire
  137. file to get important information about the file, such as, the length of
  138. each field, and the number of records in the file.  Character fields are
  139. have a double quote on each end, Number fields do not.
  140.  
  141. The following is an example of a Comma-Delimited File:
  142. "John Doe", "14 Bla Blah St", "My City", "My State", 14500
  143.  String      String            String     String     Number
  144.  
  145.  
  146.                          Fixed-Length Line Feed
  147.  
  148.         This type of file is very common.  Each field in a record is a Fixed
  149. Length, but each record has a CR/LF attached to the end.  This file would
  150. load into a word processor and each record wooould be a row.  Following is
  151. an example of a Fixed-Length Line Feed file:
  152. John Doe            14 Bla Blah St      My City             St     14500
  153. Mark Doe            27 Bogus Ave        My City             St     27000
  154. 20 Characters       20 Characters       20 Characters       2 10 Characters
  155.  
  156.         Many times a number field will be represented as a string.
  157.  
  158.  
  159.                             ASCII Line Feed
  160.  
  161.         This type of file structure is like a Mail Label output.  You
  162. must know the number of fields for the file, otherwise we cannot process
  163. it.  Following is an example of this file type:
  164. John Doe        <Field 1> -------------|
  165. 14 Bogus Ave    <Field 2>              |
  166. My City         <Field 3>              | Record 1, 6 Fields
  167. State           <Field 4>              |
  168. Zip Code        <Field 5>              |
  169. Amt Due         <Field 6> -------------|
  170. Mark Doe        <Field 1> -------------|
  171. 27 Bogus Ave    <Field 2>              |
  172. My City         <Field 3>              | Record 2, 6 Fields
  173. State           <Field 4>              |
  174. Zip Code        <Field 5>              |
  175. Amt Due         <Field 6> -------------|
  176.  
  177.  
  178.                               Fixed-Length
  179.  
  180.         This record structure has been around for a long time, probably
  181. as long as Comma-Delimited.  What this means is that, each field is a
  182. Fixed-Length but the data file is treated as one (1) long string.
  183. Following is an example of a fixed length file.
  184. John Doe            14 Bla Blah St      My City             St     14500Mark Doe
  185.             27 Bogus Ave        My City             St     27000
  186.  
  187.  
  188.  
  189.                                       - 3 -
  190.  
  191.  
  192.  
  193.  
  194.         More on Fixed-Length files:  we have included a copy of Vern
  195. Buerg's great LIST program for you to look at files.  If you don't know
  196. a files fields and field lengths this is a good way to find out.  To do
  197. this load LIST like this:  C:\>LIST <Enter>
  198. You will get a list of files to select.  Select your file and press
  199. <Enter>, when the file is displayed on the screen press <W> for Word
  200. Wrap then press <Alt-R> for the Ruler.  Now you should be able to figure
  201. out what the field lengths are.  If you have a problem with this you can
  202. always call us and we will be glad to help you.
  203.  
  204.  
  205.         The last menu option dealing with files is, Don't Know File
  206. Type. This option will ATTEMPT to figure out what file type you are
  207. processing. We say ATTEMPT because in the Fixed-Length type almost any
  208. file that does not have a CR/LF could be a Fixed-Length File, so use this
  209. option with care on Fixed-Length files.
  210.  
  211.  
  212. OUTPUT FIELDS:
  213.  
  214.         When we have all the information we need on the Input File, you
  215. will be taken to the Output Fields Screen.  As we explained in the Quick
  216. Start section you coould press <F10> to begin processing all fields or
  217. you can select which fields will go intoo the output file.  To select a
  218. field for the output file use the <UP> or <DOWN> Arrow Key to move to
  219. the field you want and press <SPACE> or <ENTER> Key.  The field
  220. information will be displayed in the window in the lower left side.  You
  221. may edit the fields in the Output Field window.  If you press the <TAB>
  222. or <LEFT ARROW> key to get to the output field window.  Watch the
  223. Messages window on the bottom of the screen and you will see the options
  224. change.
  225. WARNING: You must have at least one (1) field displayed in the Output
  226. Field window or you will not be able to move into that window.
  227.  
  228.         When in the Output Fields window you are allowed to change the
  229. Fields information such as: Name, Type, Length, and if appropriate the
  230. number of decimal places.  You may also Delete a Field, Insert a BLANK
  231. field, and combine up to Five (5) fields together.
  232.  
  233.         When you are finished with your manipulation of the file, press
  234. the <F10> key to process the file.
  235.  
  236.         This wraps up the explanation of how ConQuest Database Conversion
  237. works, if you have any problems please call us for help.  We will help you
  238. ONLY once if you are not a Registered User.
  239.  
  240.  
  241. BUG REPORT:
  242.  
  243.         Nobody likes a buggy program, especially us.  The only BUG we
  244. have encountered has to do with the Paradox Engine.  When processing to
  245. a Paradox output file, if you have some TSR's loaded it will lock up the
  246. computer when it has finished processing the file.  You will have to
  247. REBOOT, but the Paradox output file is intact and usable.
  248.  
  249.         If you find a BUG in any of our software products, we want to
  250. know.  If you notify us we will fix the bug and for registered users we
  251.  
  252.  
  253.                                       - 4 -
  254.  
  255.  
  256.  
  257.  
  258. will send a new copy of the program to you.
  259.  
  260.         If you really need to get ahold of us, you may leave a message
  261. at the Walnut Creek BBS -- (510) 937-0156 N-8-1 for Node 1
  262.                            (510) 938-5836 N-8-1 for Node 2
  263. If you call between the hours of 6 PM to 7 PM Pacific Time you will get
  264. into the system easily because this is reserved for messages only.
  265. We would like to hear from you.
  266.  
  267.  
  268. LICENSING:
  269.  
  270.         Same as everybody we need to be paid for our labor.  This
  271. program represents years of study and work by our programming staff.
  272. Please register this program and help us keep making it better. When you
  273. register we will send you the next version free of charge, (You must pay
  274. shipping costs).
  275.         To register with us you can fill out the ORDER form.  To do this,
  276. type at the DOS prompt C:\>TYPE ORDER.FRM >PRN <Enter>
  277. This will print the order form for you to fill out.
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.                                       - 5 -
  318.  
  319.